@vue/runtime-core

What is @vue/runtime-core?

The @vue/runtime-core package is a part of the Vue.js framework that provides the core runtime components necessary for Vue applications to function. It includes the logic for the virtual DOM, components, reactivity system, and other essential features that enable developers to build interactive user interfaces.

What are @vue/runtime-core's main functionalities?

Reactivity System

The reactivity system allows developers to create reactive state objects that automatically update the DOM when the state changes.

{"import { reactive } from '@vue/runtime-core';\nconst state = reactive({ count: 0 });"}

Component Creation

This feature enables developers to define Vue components using the Composition API, which is a function-based approach to creating and managing component state and behavior.

{"import { defineComponent } from '@vue/runtime-core';\nconst MyComponent = defineComponent({\n  setup() {\n    // Component logic here\n  }\n});"}

Custom Renderer API

The Custom Renderer API allows developers to create custom renderers for Vue, enabling the use of Vue's reactivity and component system with different rendering backends, such as canvas or WebGL.

{"import { createRenderer } from '@vue/runtime-core';\nconst { render } = createRenderer({\n  patchProp,\n  ...otherOptions\n});"}

Other packages similar to @vue/runtime-core

react

React is a popular JavaScript library for building user interfaces. It also has a virtual DOM, component-based architecture, and its own reactivity system. React focuses on a declarative programming model and differs from Vue in syntax and the ecosystem of tools and extensions.

preact

Preact is a fast, 3kB alternative to React with the same modern API. It provides a similar component-based architecture and virtual DOM system but aims to be smaller and faster. Preact is often used for performance-critical applications or when a smaller bundle size is needed.

inferno

Inferno is another React-like library for building high-performance user interfaces. It is heavily optimized for performance and claims to be one of the fastest JavaScript UI libraries available. Inferno shares some similarities with Vue's reactivity and component system but is more focused on performance.

svelte

Svelte is a radical new approach to building user interfaces. Unlike Vue, which updates the DOM in response to state changes, Svelte compiles components to highly optimized imperative code that surgically updates the DOM. This results in faster runtime performance and smaller bundle sizes.

README

@vue/runtime-core

This package is published only for typing and building custom renderers. It is NOT meant to be used in applications.

For full exposed APIs, see src/index.ts.

Building a Custom Renderer

import { createRenderer } from '@vue/runtime-core'

const { render, createApp } = createRenderer({
  patchProp,
  insert,
  remove,
  createElement,
  // ...
})

// `render` is the low-level API
// `createApp` returns an app instance with configurable context shared
// by the entire app tree.
export { render, createApp }

export * from '@vue/runtime-core'

See @vue/runtime-dom for how a DOM-targeting renderer is implemented.

Changelog

3.5.13 (2024-11-15)

Bug Fixes

• compiler-core: handle v-memo + v-for with functional key (#12014) (99009ee), closes #12013
• compiler-dom: properly stringify template string style (#12392) (2d78539), closes #12391
• custom-element: avoid triggering mutationObserver when relecting props (352bc88), closes #12214 #12215
• deps: update dependency postcss to ^8.4.48 (#12356) (b5ff930)
• hydration: the component vnode's el should be updated when a mismatch occurs. (#12255) (a20a4cb), closes #12253
• reactiivty: avoid unnecessary watcher effect removal from inactive scope (2193284), closes #5783 #5806
• reactivity: release nested effects/scopes on effect scope stop (#12373) (bee2f5e), closes #12370
• runtime-dom: set css vars before user onMounted hooks (2d5c5e2), closes #11533
• runtime-dom: set css vars on update to handle child forcing reflow in onMount (#11561) (c4312f9)
• ssr: avoid updating subtree of async component if it is resolved (#12363) (da7ad5e), closes #12362
• ssr: ensure v-text updates correctly with custom directives in SSR output (#12311) (1f75d4e), closes #12309
• ssr: handle initial selected state for select with v-model + v-for option (#12399) (4f8d807), closes #12395
• teleport: handle deferred teleport update before mounted (#12168) (8bff142), closes #12161
• templateRef: set ref on cached async component which wrapped in KeepAlive (#12290) (983eb50), closes #4999 #5004
• test: update snapshot (#12169) (828d4a4)
• Transition: fix transition memory leak edge case (#12182) (660132d), closes #12181
• transition: reflow before leave-active class after leave-from (#12288) (4b479db), closes #2593
• types: defineEmits w/ interface declaration (#12343) (1022eab), closes #8457
• v-once: setting hasOnce to current block only when in v-once (#12374) (37300fc), closes #12371

Performance Improvements

• reactivity: do not track inner key `__v_skip`` (#11690) (d637bd6)
• runtime-core: use feature flag for call to resolveMergedOptions (#12163) (1755ac0)